home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XListFonts.z / XListFonts
Encoding:
Text File  |  2002-10-03  |  7.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXLLLLiiiissssttttFFFFoooonnnnttttssss((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXLLLLiiiissssttttFFFFoooonnnnttttssss((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XListFonts, XFreeFontNames, XListFontsWithInfo,
  10.           XFreeFontInfo - obtain or free font names and information
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           char **XListFonts(_d_i_s_p_l_a_y, _p_a_t_t_e_r_n, _m_a_x_n_a_m_e_s,
  14.           _a_c_t_u_a_l__c_o_u_n_t__r_e_t_u_r_n)
  15.                 Display *_d_i_s_p_l_a_y;
  16.                 char *_p_a_t_t_e_r_n;
  17.                 int _m_a_x_n_a_m_e_s;
  18.                 int *_a_c_t_u_a_l__c_o_u_n_t__r_e_t_u_r_n;
  19.  
  20.           XFreeFontNames(_l_i_s_t)
  21.                 char *_l_i_s_t[];
  22.  
  23.           char **XListFontsWithInfo(_d_i_s_p_l_a_y, _p_a_t_t_e_r_n, _m_a_x_n_a_m_e_s,
  24.           _c_o_u_n_t__r_e_t_u_r_n, _i_n_f_o__r_e_t_u_r_n)
  25.                 Display *_d_i_s_p_l_a_y;
  26.                 char *_p_a_t_t_e_r_n;
  27.                 int _m_a_x_n_a_m_e_s;
  28.                 int *_c_o_u_n_t__r_e_t_u_r_n;
  29.                 XFontStruct **_i_n_f_o__r_e_t_u_r_n;
  30.  
  31.           XFreeFontInfo(_n_a_m_e_s, _f_r_e_e__i_n_f_o, _a_c_t_u_a_l__c_o_u_n_t)
  32.                 char **_n_a_m_e_s;
  33.                 XFontStruct *_f_r_e_e__i_n_f_o;
  34.                 int _a_c_t_u_a_l__c_o_u_n_t;
  35.  
  36.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  37.           _a_c_t_u_a_l__c_o_u_n_t
  38.                     Specifies the actual number of font names.
  39.  
  40.  
  41.           _a_c_t_u_a_l__c_o_u_n_t__r_e_t_u_r_n
  42.                     Returns the actual number of font names.
  43.  
  44.           _c_o_u_n_t__r_e_t_u_r_n
  45.                     Returns the actual number of matched font names.
  46.  
  47.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  48.  
  49.           _i_n_f_o__r_e_t_u_r_n
  50.                     Returns the font information.
  51.  
  52.           _f_r_e_e__i_n_f_o Specifies the font information.
  53.  
  54.  
  55.           _l_i_s_t      Specifies the array of strings you want to free.
  56.  
  57.           _m_a_x_n_a_m_e_s  Specifies the maximum number of names to be
  58.                     returned.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXLLLLiiiissssttttFFFFoooonnnnttttssss((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXLLLLiiiissssttttFFFFoooonnnnttttssss((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _n_a_m_e_s     Specifies the list of font names.
  75.  
  76.  
  77.           _p_a_t_t_e_r_n   Specifies the null-terminated pattern string that
  78.                     can contain wildcard characters.
  79.  
  80.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  81.           The _X_L_i_s_t_F_o_n_t_s function returns an array of available font
  82.           names (as controlled by the font search path; see
  83.           _X_S_e_t_F_o_n_t_P_a_t_h) that match the string you passed to the
  84.           pattern argument.  The pattern string can contain any
  85.           characters, but each asterisk (*) is a wildcard for any
  86.           number of characters, and each question mark (?) is a
  87.           wildcard for a single character.  If the pattern string is
  88.           not in the Host Portable Character Encoding, the result is
  89.           implementation-dependent.  Use of uppercase or lowercase
  90.           does not matter.  Each returned string is null-terminated.
  91.           If the data returned by the server is in the Latin Portable
  92.           Character Encoding, then the returned strings are in the
  93.           Host Portable Character Encoding.  Otherwise, the result is
  94.           implementation-dependent.  If there are no matching font
  95.           names, _X_L_i_s_t_F_o_n_t_s returns NULL.  The client should call
  96.           _X_F_r_e_e_F_o_n_t_N_a_m_e_s when finished with the result to free the
  97.           memory.
  98.  
  99.           The _X_F_r_e_e_F_o_n_t_N_a_m_e_s function frees the array and strings
  100.           returned by _X_L_i_s_t_F_o_n_t_s or _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o.
  101.  
  102.           The _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o function returns a list of font names
  103.           that match the specified pattern and their associated font
  104.           information.  The list of names is limited to size specified
  105.           by maxnames.  The information returned for each font is
  106.           identical to what _X_L_o_a_d_Q_u_e_r_y_F_o_n_t would return except that
  107.           the per-character metrics are not returned.  The pattern
  108.           string can contain any characters, but each asterisk (*) is
  109.           a wildcard for any number of characters, and each question
  110.           mark (?) is a wildcard for a single character.  If the
  111.           pattern string is not in the Host Portable Character
  112.           Encoding, the result is implementation-dependent.  Use of
  113.           uppercase or lowercase does not matter.  Each returned
  114.           string is null-terminated.  If the data returned by the
  115.           server is in the Latin Portable Character Encoding, then the
  116.           returned strings are in the Host Portable Character
  117.           Encoding.  Otherwise, the result is implementation-
  118.           dependent.  If there are no matching font names,
  119.           _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o returns NULL.
  120.  
  121.           To free only the allocated name array, the client should
  122.           call _X_F_r_e_e_F_o_n_t_N_a_m_e_s.  To free both the name array and the
  123.           font information array or to free just the font information
  124.           array, the client should call _X_F_r_e_e_F_o_n_t_I_n_f_o.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXLLLLiiiissssttttFFFFoooonnnnttttssss((((3333XXXX11111111))))   XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))    XXXXLLLLiiiissssttttFFFFoooonnnnttttssss((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           The _X_F_r_e_e_F_o_n_t_I_n_f_o function frees a font structure or an
  141.           array of font structures and optionally an array of font
  142.           names.  If NULL is passed for names, no font names are
  143.           freed.  If a font structure for an open font (returned by
  144.           _X_L_o_a_d_Q_u_e_r_y_F_o_n_t) is passed, the structure is freed, but the
  145.           font is not closed; use _X_U_n_l_o_a_d_F_o_n_t to close the font.
  146.  
  147.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  148.           XLoadFont(3X11), XSetFontPath(3X11)
  149.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.